---
title: Configuration settings
summary: Configuration keys consumed by this library, retrieval methods, and runtime dependencies.
status: draft
owner: <owner>
last_reviewed: 2026-08-21
library: SAIF.Services.Appworx
reference_type: package
---

# Configuration settings

`SAIF.Services.Appworx` exposes no externally configurable application settings of its own. Its configuration surface is limited to the Oracle ODP.NET provider registration in `App.config`/`Web.config`, plus two hardcoded (non-externalized) Oracle target identifiers used only when a caller opts into the non-production environment override.

## Configuration retrieval methods

| Method | Class / Interface | Namespace | Usage pattern |
| --- | --- | --- | --- |
| `AppGlobal.EnvironmentService.GetApplicationEnvironment()` | `AppGlobal.EnvironmentService` | `SAIF.BOF.Framework.Security.EnvironmentApi` (referenced package) | Called in the shared `SubmitBatchJob` overload to decide between the `WCISPROD` and `WCISDEV1` Oracle targets when `inUseWCISDEV1AppworxForAllDevEnv = True`. |

## Environment API settings

No `IEnvironmentService`-backed configuration keys (e.g., `GetConfigSetting`/`GetSecureConfigSetting`) were found in this library's own source**.

## AppSettings (Web.config)

No `ConfigurationManager.AppSettings`-based configuration keys were found in this library's `App.config`/`Web.config` beyond the Oracle provider registration listed below**.

## Database connection configuration

| Connection name | Provider | Retrieval method | Purpose | Source |
| --- | --- | --- | --- | --- |
| Oracle ODP.NET managed provider | `Oracle.ManagedDataAccess.Client.OracleClientFactory` | `DbProviderFactories` registration | Registers the Oracle managed provider factory so `System.Data` can resolve Oracle connectivity for the underlying SAIF BOF data portal. | `SAIF.Services.Appworx\App.config`, `SAIF.Services.Appworx\Web.config` |
| `oracle.manageddataaccess.client` config section | Oracle ODP.NET managed driver | Config section handler declaration | Declares the ODP.NET managed-driver configuration section handler used by the underlying data portal. | `SAIF.Services.Appworx\App.config`, `SAIF.Services.Appworx\Web.config` |
| Hardcoded Oracle targets `"WCISPROD"` / `"WCISDEV1"`, schema `"PRADT"` | `clsMSOracleDataLayer` (referenced package) | Literal string constants in source | Non-externalized database-target identifiers used when `inUseWCISDEV1AppworxForAllDevEnv = True` in the shared `SubmitBatchJob` overload (see [BR-APX-003](business-rules.md#br-apx-003-non-production-appworx-target-override)); compiled into the class rather than read from `AppSettings`/`ConfigurationManager`* | `SAIF.Services.Appworx\clsRequestAppworxJob.vb` |

## Secure settings

No secure/encrypted configuration settings were found in this library's own source**.

## Transitive configuration (from dependencies)

| Setting key | Method | Source dependency | Dependency type | Purpose |
| --- | --- | --- | --- | --- |
| Assembly binding redirects (`System.Text.Json` → 6.0.0.3, `System.Runtime.CompilerServices.Unsafe` → 6.0.0.0) | `<assemblyBinding>` in `App.config` | NuGet-generated | NuGet Package | Standard binding redirects for transitive dependency version conflicts; not application-specific configuration. |

## Configuration dependencies

| Dependency | Type | Required at | Impact if missing |
| --- | --- | --- | --- |
| `Oracle.ManagedDataAccess.Client` `DbProviderFactories` registration | Config file section | Runtime (job submission) | Without this registration, the underlying SAIF BOF data portal cannot resolve the Oracle provider and `submit_appworx_job` calls would fail**. |
| `SAIF.BOF.Framework.Security.EnvironmentApi`'s environment-service backing store | External package configuration | Runtime, only when `inUseWCISDEV1AppworxForAllDevEnv = True` | If the environment service cannot resolve the current environment, the target-selection branch in [BR-APX-003](business-rules.md#br-apx-003-non-production-appworx-target-override) behavior is undefined from this library's perspective**. |

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Related documentation
- [Library index](index.md)
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [Database tables](database-tables.md)
- [SQL catalog](sql/index.md)
- [Stored procedures](procedures/index.md)
- [API reference](api/index.md)

## Sources
- `SAIF.Services.Appworx\clsRequestAppworxJob.vb`
- `SAIF.Services.Appworx\App.config`
- `SAIF.Services.Appworx\Web.config`